Porting Guide for Planet Hively
-------------------------------

* When porting to a new platform, please make a new platform
  section in the makefile where you can set compiler and linker
  flags.

* Try to keep any platform specific code inside #ifdef blocks
  to keep portability.

* Please email the binary for your port as well as any code
  changes to pete@petergordon.org.uk so that the release can
  be added to hivelytracker.com and any code changes can be
  merged with the "official" source.

* Feel free to optimise any routines; a lot of them are
  quite slow.

* You can set the following defines in the makefile if your target
  platform requires them:
  
  -DDEFAULT_WIDTH=X
  -DDEFAULT_HEIGHT=Y
  
    Sets the default resolution to XxY instead of 640x480.
    Only set this if you really have to because Planet Hively's
    design is based around 640x480, even though it does 
    (more-or-less) scale.

  -D__FIXED_RES__
  
    Set this if your target device has a fixed display mode
    (which you can specify with DEFAULT_WIDTH and DEFAULT_HEIGHT).

  -D__SW_SURFACE__
  
    If this is set, Planet Hively will always use a software
    surface. Note that usually this is slower since the code doesn't
    ever read from the surface buffer directly, however it might
    be necessary if SDL hardware surfaces are problematic on your
    target platform.

  -D__HW_ONLY_WINDOWED__
  
    If this is set, Planet Hively will use a software surface in
    fullscreen mode and a hardware one when windowed. Under windows
    it seems to be the best way to do things.
